/**
 * 文件名：ApiResponse.java
 * 功能：统一 API 响应格式封装类
 * 作用：封装所有接口的返回数据，提供统一的响应结构（code, message, data, timestamp）
 * 模块关系：
 *   - 被所有 Controller 使用：包装返回结果
 *   - 被 GlobalExceptionHandler 使用：封装错误响应
 *   - 前端解析：Vue3 和微信小程序的 http.js 中自动解析此结构
 *   - 支持泛型：可封装任意类型的数据
 * 作者：白永康
 * 学号：2501210209
 */
package com.example.demo.common;

import java.time.Instant;

/**
 * 统一 API 响应类
 * 提供统一的响应格式，包含状态码、消息、数据和时间戳
 * @param <T> 数据类型
 */
public class ApiResponse<T> {
    /** 响应状态码（0 表示成功，非 0 表示失败） */
    private int code;
    
    /** 响应消息 */
    private String message;
    
    /** 响应数据 */
    private T data;
    
    /** 响应时间戳（毫秒） */
    private long timestamp;

    /**
     * 无参构造函数
     */
    public ApiResponse() {}

    /**
     * 全参数构造函数
     * @param code 状态码
     * @param message 消息
     * @param data 数据
     */
    public ApiResponse(int code, String message, T data) {
        this.code = code;
        this.message = message;
        this.data = data;
        this.timestamp = Instant.now().toEpochMilli();
    }

    /**
     * 成功响应（带数据）
     * @param data 返回数据
     * @return ApiResponse 实例
     */
    public static <T> ApiResponse<T> ok(T data) { 
        return new ApiResponse<>(0, "OK", data); 
    }
    
    /**
     * 成功响应（无数据）
     * @return ApiResponse 实例
     */
    public static <T> ApiResponse<T> ok() { 
        return new ApiResponse<>(0, "OK", null); 
    }
    
    /**
     * 失败响应
     * @param code 错误码
     * @param message 错误消息
     * @return ApiResponse 实例
     */
    public static <T> ApiResponse<T> fail(int code, String message) { 
        return new ApiResponse<>(code, message, null); 
    }

    // Getter 和 Setter 方法
    public int getCode() { return code; }
    public void setCode(int code) { this.code = code; }
    
    public String getMessage() { return message; }
    public void setMessage(String message) { this.message = message; }
    
    public T getData() { return data; }
    public void setData(T data) { this.data = data; }
    
    public long getTimestamp() { return timestamp; }
    public void setTimestamp(long timestamp) { this.timestamp = timestamp; }
}
